
  What LAME is:
  ~~~~~~~~~~~~~

  LAME is a command-line program which encodes digital audio into
  the lossy compression format known as "mp3".  See the
  documentation for more details.



  Other recommended software:
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~

  Useful software to use in conjunction with LAME:

  - MP3Enc - by Justin Fletcher -
        Desktop front-end for various mp3 encoders.
          Supports LAME.

  - AMPlayer - by Thomas Olsson, Robin Watts and Justin Fletcher -
        A very nice, fully featured mp3 player.

  - SoundCon - by Rick Hudson -
        Sound sample conversion utility which might help with audio
          formats commonly found on RISC OS.

  - SuperFPE by myself -
        Speeds up emulation of floating point instructions a bit.
          (does not now benefit recent versions of LAME).



  Known bugs/problems with LAME:
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  - The resampling code gives wrong results when compiled with
    -msoft-float because it's evil... but the output sounds Ok...
    Solution: If you must use resampling and you're paranoid about
    the quality, resample with with a seperate utility eg: !SoundCon.
    (PS: This problem does not affect LameFE)

  - RISC OS filename munging needed for when LAME appends
    ".mp3" or ".wav".


  Report any additional bugs to <mech@toth.org.uk>



  Useful LAME CLI usage examples:
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  - To encode raw CD data as a low quality mp3 (no psy-model)
    at about 75% the speed of Shine (but slightly more accurately):
      "lame -b 128 -r -m s -q 9 <infile> <outfile>"

  - To encode raw CD data as a variable bitrate mp3 at
    maximum quality with joined stereo and error protection:
      "lame -v -V 0 -q 0 -r -m j -p <infile> <outfile>"
        (WARNING: Slooooow)

  - To decode an mp3 and convert to a WAV file:
      "lame --mp3input --decode <infile> <outfile>"

  - Ultra-fast, ultra-low-quality mono encoding:
      "lame -b 32 -r -m m -a -q 9 --resample 44100 --disptime 10 <infile> <outfile>"

  - For more information read the docs or type:
    "lame --longhelp"



  Contacting me:
  ~~~~~~~~~~~~~~

  My email address is:  mech@toth.org.uk  and I may even reply if I
  notice I have new mail.
